<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>vpowv_i</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
    <link rel="prev" href="vpowv.html" title="vpowv" />
    <link rel="next" href="vpvoc.html" title="vpvoc" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">vpowv_i</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="vpowv.html">Prev</a> </td>
          <th width="60%" align="center">Orchestra Opcodes and Operators</th>
          <td width="20%" align="right"> <a accesskey="n" href="vpvoc.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="vpowv_i"></a>
      <div class="titlepage"></div>
      <a id="IndexVpowv_i" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">vpowv_i</span>
        </h2>
        <p>vpowv_i — 
      Performs power-of operations between two vectorial control signals at init time.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp165850336"></a>
        <h2>Description</h2>
        <p>
      Performs power-of operations between two vectorial control signals at init time.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp165851600"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>vpowv_i</strong></span> ifn1, ifn2, ielements [, idstoffset] [, isrcoffset]</pre>
      </div>
      <div class="refsect1">
        <a id="idp165853616"></a>
        <h2>Initialization</h2>
        <p>
      <span class="emphasis"><em>ifn1</em></span>  - number of the table hosting the first vector to be processed
    </p>
        <p>
      <span class="emphasis"><em>ifn2</em></span>  - number of the table hosting the second vector to be processed
    </p>
        <p>
      <span class="emphasis"><em>ielements</em></span> - number of elements of the two vectors
    </p>
        <p>
      <span class="emphasis"><em>idstoffset</em></span> - index offset for the destination (ifn1) table
    </p>
        <p>
      <span class="emphasis"><em>isrcoffset</em></span> - index offset for the source (ifn2) table
    </p>
      </div>
      <div class="refsect1">
        <a id="idp165858688"></a>
        <h2>Performance</h2>
        <p>
      <span class="emphasis"><em>vpowv_i</em></span> raises each element of ifn1 to the corresponding element of ifn2. Each vectorial signal is hosted by a table (ifn1 and ifn2). The number of elements contained in both vectors must be the same.
    </p>
        <p>
      The result is a new vectorial control signal that overrides old values of ifn1. If you want to keep the old ifn1 vector, use <a class="link" href="vcopy_i.html" title="vcopy_i"><em class="citetitle">vcopy_i</em></a> opcode to copy it in another table. You can use <span class="emphasis"><em>idstoffset</em></span> and <span class="emphasis"><em>isrcoffset</em></span> to specify vectors in any location of the tables.
    </p>
        <p>
      Negative values for <span class="emphasis"><em>idstoffset</em></span> and <span class="emphasis"><em>isrcoffset</em></span> are acceptable. If <span class="emphasis"><em>idstoffset</em></span> is negative, the out of range section of the vector will be discarded. If <span class="emphasis"><em>isrcoffset</em></span> is negative, the out of range elements will be assumed to be 1 (i.e. the destination elements will not be changed). If elements for the destination vector are beyond the size of the table (including guard point), these elements are discarded (i.e. elements do not wrap around the tables). If elements for the source vector are beyond the table length, these elements are taken as 1 (i.e. the destination vector will not be changed for these elements).
    </p>
        <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
          <table border="0" summary="Warning">
            <tr>
              <td rowspan="2" align="center" valign="top" width="25">
                <img alt="[Warning]" src="images/warning.png" />
              </td>
              <th align="left">Warning</th>
            </tr>
            <tr>
              <td align="left" valign="top">
                <p>
        Using the same table as source and destination table in versions earlier than 5.04, might produce unexpected behavior, so use with care.
      </p>
              </td>
            </tr>
          </table>
        </div>
        <p>
      This opcode works at init time. There's an k-rate version of this opcode called <a class="link" href="vpowv.html" title="vpowv"><em class="citetitle">vpowv</em></a>.
    </p>
        <p>
      All these operators (<a class="link" href="vaddv_i.html" title="vaddv_i"><em class="citetitle">vaddv_i</em></a>,<a class="link" href="vsubv_i.html" title="vsubv_i"><em class="citetitle">vsubv_i</em></a>,<a class="link" href="vmultv_i.html" title="vmultv_i"><em class="citetitle">vmultv_i</em></a>,<a class="link" href="vdivv_i.html" title="vdivv_i"><em class="citetitle">vdivv_i</em></a>,<a class="link" href="vpowv_i.html" title="vpowv_i"><em class="citetitle">vpowv_i</em></a>,<a class="link" href="vexpv_i.html" title="vexpv_i"><em class="citetitle">vexpv_i</em></a>, <a class="link" href="vcopy.html" title="vcopy"><em class="citetitle">vcopy</em></a> and <a class="link" href="vmap.html" title="vmap"><em class="citetitle">vmap</em></a>) are designed to be used together with other opcodes that operate with vectorial signals such as <a class="link" href="vcella.html" title="vcella"><em class="citetitle">vcella</em></a>, <a class="link" href="adsynt.html" title="adsynt"><em class="citetitle">adsynt</em></a>, <a class="link" href="adsynt2.html" title="adsynt2"><em class="citetitle">adsynt2</em></a> etc. 
    </p>
      </div>
      <div class="refsect1">
        <a id="idp165878880"></a>
        <h2>Credits</h2>
        <p>Written by Gabriel Maldonado. Optional arguments added by Andres Cabrera and Istvan Varga.</p>
        <p>New in Csound 5 (Previously available only on CsoundAV)</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="vpowv.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="OpcodesTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="vpvoc.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">vpowv </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> vpvoc</td>
        </tr>
      </table>
    </div>
  </body>
</html>
